package com.travel.result;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 统一返回结果类
 * 用于封装所有接口的返回结果，提供统一的数据格式
 * @param <T> 返回的数据类型
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Result<T> {
    /**
     * 状态码
     * 200：成功
     * 500：错误
     * 401：未认证
     * 403：无权限
     * 404：未找到
     */
    private Integer code;

    /**
     * 返回信息
     * 用于描述接口调用结果
     */
    private String message;

    /**
     * 返回数据
     * 泛型T允许返回任意类型的数据
     */
    private T data;

    /**
     * 成功返回结果
     * @param <T> 返回数据的类型
     * @return Result对象
     * 例如：return Result.success(student);
     */
    public static <T> Result<T> success() {
        Result<T> result = new Result<>();
        result.setCode(ResultCode.SUCCESS);
        result.setMessage("操作成功");
        return result;
    }

    /**
     * 成功返回结果（带自定义消息）
     * @param data 返回的数据
     * @param <T> 返回数据的类型
     * @return Result对象
     * 例如：return Result.success("登录成功", userInfo);
     */
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(ResultCode.SUCCESS);
        result.setData(data);
        return result;
    }

    /**
     * 错误返回结果
     * @param message 错误信息
     * @param <T> 返回数据的类型
     * @return Result对象
     * 例如：return Result.error("用户名或密码错误");
     */
    public static <T> Result<T> error(String message) {
        Result<T> result = new Result<>();
        result.setCode(ResultCode.ERROR);
        result.setMessage(message);
        return result;
    }
    
    /**
     * 自定义错误码的失败返回结果
     * @param code 错误码
     * @param message 错误信息
     * @param <T> 返回数据的类型
     * @return Result对象
     * 例如：return Result.fail(401, "用户未登录");
     */
    public static <T> Result<T> fail(Integer code, String message) {
        Result<T> result = new Result<>();
        result.setCode(code);
        result.setMessage(message);
        return result;
    }
} 